PROGRAM LICENSE =============== PicPoc 2.2a is owned and (c)Copyright 1994,1995 by Berthold Daum. All Rights Reserved. This program is a shareware program. The future development of this program depends on the number of people registering. ------------------------------------- ! Warning ! ! ! The unregistered version of this ! ! program cannot store bitmaps ! ! larger than 48*48 pixels. ! ------------------------------------- Disclaimer ---------- Although PicPoc has been extensively tested, the author shall not be responsible for any loss of any kind due to its use. It is the user's responsibility to establish the suitability of this software for any particular purpose. Registration ------------ Please use ORDER.FRM. The registration fee is A$49.95 plus postage and handling. Please send your registration to: Berthold Daum lichtbild p/l 21 Margate St. Beaumaris, Vic. 3193 Australia CompuServe 100026,3365 INTERNET: 100026.3365@compuserve.com We supply you with a registration number via e-mail or by mail. NEW!!! Recommendation program ----------------------------- We distribute our programs directly to offer you the lowest prices as possible. Direct distribution depends very much on mouth-to-mouth recommendation. We would like to acknowledge this fact by honouring the recommenation of our products. If you are a registered user of any of our products, and another user quotes your name when he registers, we will send you a floppy disc with the newest versions of the products you had registered absolutely free ! PicPoc Version 2.2a - Release Notes =================================== Program Description ------------------- Advanced painting tool for PSION Series 3a computers. Includes features such as: Polyline, Rectangle, Rhomb, Ellipse, Text, Pen, Eraser, Fill, Spray, Lupe, Undo, Copy, Cut, Paste, adjustable pen, eraser, and spray size, different text fonts and styles, different and user definable fill patterns, scrolling in large bitmaps. Platforms --------- This program runs on PSION S3a and ACORN PocketBook II computers. Requirements ------------ The installation routine informs of the size of each option. A full installation needs approx. 40k disk space. When active, the system requires >11k of memory depending on the size of the image. New in Version 2.1 ------------------ - A new shape: rhomb - Selectable and user definable shapes for pen, eraser and spray - The lupe has now a separate menu. - Pattern clusters can now be of any size. pattern height and size is a third of cluster height and width. This allows a lower pattern frequency. - Pressing the Shift key when using the cursor keys for scrolling tilts the cursor direction by 45 degrees against the clock. This makes it easy to draw diagonals, squares, "square" rhombs, and circles. - Definable background colour. - Insertion mode : set,delete,invert,replace. - view clipboard, clear clipboard (to save memory) - Undo can be switched off (to save memory) - extensive help system - Series 3a support - big screen size - support of colour grey in all operations - support of all internal fonts of Series 3a - S3a like user interface New in Version 2.15 ------------------- - Place operation (PSION-Shift-O) reads a new bitmap from a selected file and insert it at the cursor position. The place operation uses the insertion mode settings (set,delete,invert,replace) in "Preferences". New in Version 2.2 ------------------ - Print function (PSION-Shift-H) Prints graphic on Epson or HP compatible printers (see below) - Print setup (PSION-Shift-Y) - Save clipboard as bitmap file (PSION-Shift-A) - Use clipboard content as fill pattern - Apply filter (PSION-K) (see below) - Apply filter to clipboard (PSION-Shift-K) - Modifiable cursor size - Modifiable step width for PSION-key - Place operation can load single planes (black, grey) When a black/grey bitmap is placed into a black-only bitmap, grey will be simulated with a pattern. - New key combination: PSION-ENTER Positions cursor to top left corner Selects whole image for copy, cut, clear, filter. Printing graphics ----------------- Graphics can be printed on Epson, HP, or compatible printers. Do not print graphical data through MCPRINT, as output may be garbled ! Instead print through MCLINK: - Start RemoteLink on the palmtop. - Assign the host printer port as a printfile via PSION-Y (e.g. REM::LPT1 on a PC) Other platforms: - Set the printfile to a local file - after printing transfer this file to the host - then print the transferred file out (e.g. file type "Printout" on Acorn). However, you can also print to a directly connected printer. Filters ------- Picpoc allows to apply predefined or user written filters to bitmap areas or to the clipboard. The following filters are delivered with PicPoc: ROTATE : Rotation 90, 180, 270 degree FLIP : Flip horizontal or vertical ENLARG : Enlarges or stretch by factor 2-8 Useful to convert S3 icons into S3a icons. Copy icon into clipboard, apply ENLARG filter to clipboard, and insert into new bitmap. REDUCE : Reduce by factor 2-8 SKEW : Skew to the left, right, upwards, downwards in angles from 0-45 degree. SHADOW : Create grey shadows (pixel distance can be specified) To write user filters is quite simple. Each filter module must contain a procedure proc filter%:(indrw%,planes%) indrw% = handle of drawable containing input bitmap planes% = number of planes of drawable The filter procedure must create a new drawable with the same number of planes. The new drawable contains the modified bitmap. The handle of this drawable is returned as the result of filter%:. If you had created other drawables during the filter operation make sure to close them before leaving the filter. Then translate the filter and install the resulting OPO-module into folder \APP\PICPOC\FILTER\ . Examples: FLIP.OPL and SHADOW.OPL Installation ============ Host platforms -------------- We deliver our products via email or on 3.5" floppy discs (1.44 MB IBM Format) On request we can send out 720 kB floppy discs. These formats can be read by PC, Mac, Amiga, Atari, Acorn. If you received the software via email or downloaded it from an electronic network you will received it in compressed format (PKZIPF). You will need the latest version of PKUNZIP to decompress the software. On the Macintosh do not use the standard UNZIP utility. Instead, use the ZIPIT utility which you will find on your network. In ZIPIT uncheck the box that says: "By default, smart-strip line feeds from text files." As a rule of thumb avoid options containing the word "smart". Installation from PC or Mac --------------------------- 1. Decompress the software (see above). 2. Connect your Series3 computer to your PC or Mac. Start MCLINK and activate "Remote link" from the PSIONs system screen. 3. Set the cursor under the RunOPL-icon (not under the OPL editor!) and press TAB. When the file selection screen appears, press TAB again. In the first line of the dialog box specify the name of the installation directory (where the new software is stored), e.g. REM::C:\CSERVE\DOWNLOAD\ A file selection list appears. 4. Select the file !setup3.opa (first file). Press ENTER. SetUp3 now takes control. The screen goes blank for a few seconds. Don't panic. A file selector box appears. 5. If the file selector box shows the product name, just press ENTER. If the file selector box shows a language, choose a language of your choice. If your language is not mentioned, select "international", which is English. 6. The file transfer starts. If the product was installed before, SetUp3 will start a dialog asking you if you want to (Continue) = Overwrite existing version (Other drive) = Install new version on different drive (Options only) = Install options you did not install the first time. 7. SetUp3 asks you on which drive you want to install the software and on which drive you usually keep your data. We recommend flash memory for the system and usually RAM for data. 9. SetUp3 will ask you about optional modules. You can decide to install them now, or you can leave it for later. 10.SetUp3 will give instructions on how to proceed after the successful transfer. Installation from other platforms --------------------------------- On other platforms than PC or Mac there are two possibilities: A) You have enough free memory, preferably on internal memory, RAM or a spare Flash pack. Proceed as follows: 1. Decompress the software (see above). 2. Transfer the whole installation folder to a new installation folder on the palmtop (M:\INSTAL\ for instance). However, there is no need to tranfer *.ZIP, *.TXT, and *.FRM files, so you may leave these ones out. 3. Set the cursor under the RunOPL-icon (not under the OPL editor!) and press TAB. When the file selection screen appears, navigate to the new installation folder on the palmtop. Continue as described above under (4). After installation is completed remove the installation folder from the palmtop. B) If you do not have so much memory an assisted manual installation is still possible. Proceed as follows: 1. Decompress the software (see above). 2. Connect your Series3 computer to your host computer. Start the host communications software and activate "Remote link" from the PSIONs system screen. 3. Copy !setup3.opa into M:\APP\ . Copy a *.ipf file of your choice into M:\APP\ . Install !setup3 to the system screen (see user manual). 4. Activate !setup3 by positioning the highlight under it and pressing ENTER. A file selector box appears. 5. Acknowledge the file selector box by pressing ENTER. 6. The installation begins. If the product was installed before, SetUp3 will start a dialog asking you if you want to (Continue) = Overwrite existing version (Other drive) = Install new version on different drive (Options only) = Install options you did not install the first time. 7. SetUp3 asks you on which drive you want to install the software and on which drive you usually keep your data. We recommend flash memory for the system and usually RAM for data. 9. SetUp3 will ask you about optional modules. You can decide to install them now, or you can leave it for later. 10.SetUp3 will ask you to copy files from the installation directory on the host computer to a target destination on the PSION. Start the file transfer from your host computer. When the file has been transmitted, acknowledge be pressing ENTER on the PSION. 11.SetUp3 will give instructions on how to proceed after the successful transfer. When things go wrong -------------------- If the installation does not run smoothly, do not try to install manually. The chance is, that if Setup3 or the installation control (IPF) file was corrupted, that other modules are corrupted, too. Please read the instructions again and repeat installation. You could also try to use a lower transmission speed between host and PSION. If the problem should persist, check for data corruption. Order another floppy disc, or download again. If the problem still persists, please seek our advice. Morpheus -------- Please do not send us questions "What is Morpheus". Instead read this: One of the tricky things when writing OPL-applications is the HELP-key. For instance, it is not possible to react to the HELP-key when a menu or a dialog box is on the screen, which is not very nice, because you may want help to fill out that dialog box. That is the reason why we created Morpheus. Morpheus is a independent application which runs in the background and intercepts the HELP-key. Morpheus checks which application is in the foreground and will then display the appropriate help texts. The other function of Morpheus is to handle alarms (for the products ProPoc and HyperPoc). It can do this better than the Agenda. Morpheus is launched automatically by any application that uses Morpheus' services. Morpheus will stay active as long as a client application is active or any Morpheus-alarms are scheduled. (The actual shutdown may be delayed for 1 minute). So, usually you don't have to shutdown Morpheus manually. One of the beauties of the system is that Morpheus can serve many masters. So if you use some of our products simultanously, still only one copy of Morpheus will be active. All our installations install Morpheus to the internal drive even if you have chosen another system drive, because that is the best place. Installing Morpheus to an SSD would cause later problems, because you would not be able to reformat that disk without stopping Morpheus manually. If you must, here is the way: Install Morpheu2 to the system screen (see user manual) Then press PSION-Z(S3) or SHIFT-PSION-X(S3a) to kill Morpheus. If Morpheus was running it will respond with a beep and will die. Deinstall Morpheus (see user manual). Deinstallation -------------- To deinstall the application from you palmtop proceed as follows. 1. First backup your system. 2. If you don't have other applications that use Morpheus: Stop Morpheus as described above. Remove MORPHEU2.OPA and folder \MORPHEU2 from the folder M:\APP. 3. n.a. 4. If you do not have other applications from us (POC-appications) remove the folder \APP\COMMON from the system drive. 5. Remove the file PICPOC.OPA and the folder PICPOC from the folder APP on the system drive. 6. Remove the datafolders PIC from the data drive(s). 7. Remove the license file PICPOC.$$$ from the root directory M:\ Documentation ------------- An extensive help file is supplied. A printed manual comes with registration. A printer manual is send on registration. Acknowledgements ---------------- Thanks to Lonnie Dworkin for PATTERN2. Thanks to Eberhard Rompf for PATTERN3-9.